Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie Spatial Characteristics

SetTrackMatrix

The SetTrackMatrix function allows your application to establish a track's transformation matrix.

pascal void SetTrackMatrix (Track theTrack, 
                              const MatrixRecord *matrix);

theTrack

Specifies the track for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively).

matrix

Contains a pointer to a matrix structure that contains the track's new matrix. If you set this parameter to nil, the Movie Toolbox uses the identity matrix.

DESCRIPTION

The Movie Toolbox uses a track's matrix to map a track from its own coordinate system into a movie's display coordinate system.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

SEE ALSO

You can get a track's matrix with the GetTrackMatrix function, which is described in the next section.

The Movie Toolbox provides a number of functions that allow you to manipulate track matrices. See "Matrix Functions" beginning on page 2-321 for information about these functions.